# Q. What is this file?
# A. This file contains options which allow you to configure your multiworld experience while allowing
#    others to play how they want as well.
#
# Q. How do I use it?
# A. The options in this file are weighted. This means the higher number you assign to a value, the
#    more chances you have for that option to be chosen. For example, an option like this:
#
#    map_shuffle:
#      on: 5
#      off: 15
#
#    Means you have 5 chances for map shuffle to occur, and 15 chances for map shuffle to be turned
#    off.
#
# Q. I've never seen a file like this before. What characters am I allowed to use?
# A. This is a .yaml file. You are allowed to use most characters.
#    To test if your yaml is valid or not, you can use this website:
#        http://www.yamllint.com/
#    You can also verify that your Archipelago options are valid at this site:
#        https://archipelago.gg/check

# Your name in-game, limited to 16 characters.
#     {player} will be replaced with the player's slot number.
#     {PLAYER} will be replaced with the player's slot number, if that slot number is greater than 1.
#     {number} will be replaced with the counter value of the name.
#     {NUMBER} will be replaced with the counter value of the name, if the counter value is greater than 1.
name: Player{number}

# Used to describe your yaml. Useful if you have multiple files.
description: Default UFO 50 Template

game: UFO 50
requires:
  version: 0.6.6 # Version of Archipelago required for this yaml to work as expected.

UFO 50:
  ################
  # Game Options #
  ################
  progression_balancing:
    # A system that can move progression earlier, to try and prevent the player from getting stuck and bored early.
    # 
    # A lower setting means more getting stuck. A higher setting means less getting stuck.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 99
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-99: 0 # random value between 0 and 99
    disabled: 0 # equivalent to 0
    normal: 50 # equivalent to 50
    extreme: 0 # equivalent to 99

  accessibility:
    # Set rules for reachability of your items/locations.
    # 
    # **Full:** ensure everything can be reached and acquired.
    # 
    # **Minimal:** ensure what is needed to reach your goal can be acquired.
    full: 50
    minimal: 0

  ###################
  # General Options #
  ###################
  always_on_games:
    # Choose which games you would like to enable.
    # 
    # The following games have full implementations: Barbuta, Vainger, Night Manor, and Porgy.
    # There is a host.yaml setting that you must enable to include unimplemented games.
    # Unimplemented games will only have Garden, Gold, and/or Cherry checks.
    # The host.yaml setting is not required for the following games due to their short length:
    # Ninpek, Magic Garden, Velgress, and Waldorf's Journey
    ['Barbuta']

  random_choice_games:
    # Choose which games have a chance of being enabled.
    # The number of games that will be enabled is based on the Random Choice Game Count option.
    []

  random_choice_game_count:
    # Choose how many Random Choice Games will be included alongside your Always On Games.
    # If your Random Choice Game Count is larger than the number of games in your Random Choice Games list, all of them will be enabled.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 50
    0: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-50: 0 # random value between 0 and 50

  starting_game_amount:
    # Choose how many games to have unlocked at the start.
    # At least one of the starting games will always be one of the implemented games, to avoid issues with generation and very early BK.
    # If this value is higher than the number of games you selected, you will start with all of them unlocked.
    # If you put a game in your start inventory from pool, it will count towards the amount from this option.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 1
    # Maximum value is 50
    1: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-1-50: 0 # random value between 1 and 50

  goal_games:
    # Choose which games you may have to complete to achieve your goal.
    ['Rakshasa', 'Onion Delivery', 'Caramel Caramel', 'Combatants', 'Campanella', 'Magic Garden', 'Quibble Race', 'Attactics', 'Velgress', "Waldorf's Journey", 'Barbuta', 'Campanella 3', 'Rail Heist', 'Camouflage', 'Cyber Owls', 'Mortol II', 'Divers', 'Fist Hell', 'Paint Chase', 'Bug Hunter', 'Mortol', 'Bushido Ball', 'Rock On! Island', 'Block Koala', 'Star Waspir', 'Party House', 'Pilot Quest', 'Night Manor', 'Warptank', 'Porgy', 'Planet Zoldath', 'Vainger', 'Hyper Contender', 'The Big Bell Race', 'Avianos', 'Hot Foot', 'Valbrace', 'Lords of Diskonia', 'Overbold', 'Campanella 2', 'Mini & Max', 'Devilition', "Elfazar's Hat", 'Golfaria', 'Grimstone', 'Seaside Drive', 'Kick Club', 'Pingolf', 'Ninpek', 'Mooncat']

  goal_game_amount:
    # Choose how many games you need to goal to achieve your goal among your Goal Games.
    # If this number is less than the number of Goal Games you have selected, it will choose some of them at random to be your Goal Games.
    # If this number is greater than or equal to your number of Goal Games, then all of your games will be your Goal Games.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 1
    # Maximum value is 50
    50: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-1-50: 0 # random value between 1 and 50

  cherry_allowed_games:
    # Choose which games you want to include the Cherry goal in.
    # If the game is set as your Goal Game, then you will need to Cherry that game to complete that goal.
    # If the game is not set as a Goal Game, then Cherrying that game will be a check.
    # If the game is not selected at all, then this option will not affect it.
    # The defaults are ones where we believe the Cherry goal is reasonable in the context of a randomizer.
    ['Night Manor', 'Barbuta']

  #################
  # Porgy Options #
  #################
  porgy_fuel_difficulty:
    # Determine how much fuel you need to get checks.
    # Hard means an efficient route with minimal damage.
    # Medium means 25% more fuel than Hard.
    # Easy means 50% more fuel than Hard.
    easy: 0
    medium: 50
    hard: 0

  porgy_check_on_touch:
    # If enabled, you will check a location as soon as you touch it, rather than having to bring it back.
    # For a shorter, quicker experience.
    'false': 50
    'true': 0

  porgy_radar:
    # Choose how the Radar System and its logic behave.
    # Always On: The Radar System is always on without needing to equip it or receive it.
    # Not Required: The Radar System is not logically required for concealed locations.
    # Required: The Radar System is logically required for all concealed locations.
    # Required No Tell: The Radar System is logically required for concealed locations without a visual cue.
    always_on: 0
    not_required: 0
    required: 50
    required_no_tell: 0

  porgy_lanternless:
    # If enabled, you will not logically require the Spotlight in the Abyss area.
    'false': 50
    'true': 0

  #######################
  # Night Manor Options #
  #######################
  nm_early_pin:
    # If enabled, the Hairpin will be on the floor in the starting room on either the Bowl or Spoon checks.
    'false': 0
    'true': 50

  ###########################
  # Item & Location Options #
  ###########################
  local_items:
    # Forces these items to be in their native world.
    []

  non_local_items:
    # Forces these items to be outside their native world.
    []

  start_inventory:
    # Start with the specified amount of these items. Example: "Bomb: 1"
    {}

  start_inventory_from_pool:
    # Start with the specified amount of these items and don't place them in the world. Example: "Bomb: 1"
    # 
    # The game decides what the replacement items will be.
    {}

  start_hints:
    # Start with these item's locations prefilled into the ``!hint`` command.
    []

  start_location_hints:
    # Start with these locations and their item prefilled into the ``!hint`` command.
    []

  exclude_locations:
    # Prevent these locations from having an important item.
    []

  priority_locations:
    # Prevent these locations from having an unimportant item.
    []

  item_links:
    # Share part of your item pool with other players.
    []

  plando_items:
    # Generic items plando.
    []
